home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / X_PATH.ARJ / XPATH.DOC next >
Text File  |  1992-01-01  |  14KB  |  397 lines
  1.                             Glossbrenner's DOS 5
  2.                     -- The Programs that DOS Forgot! --
  3.  
  4.                               XPATH Version 3.9
  5.                               -----------------
  6.  
  7.     Have you ever tried to set your path longer than  127 
  8.     characters?  Without XPATH, or a similar product, it just 
  9.     can't be done.  The reason is that you cannot type more 
  10.     than 128 characters at the prompt.  Even if you create a 
  11.     BAT file where you can type more than 128 characters on a 
  12.     line, you cannot set your path past 127 characters because 
  13.     the command interpreter will not read past the 128th column 
  14.     of your BAT file.  
  15.  
  16.     This problem is solved when you use XPATH.  With XPATH, 
  17.     you create a file that contains 1 line for each 
  18.     directory you want in your path.  You then simply 
  19.     execute XPATH, specifying the file that contains the 
  20.     directories you want in your path. 
  21.  
  22.     For example, say you want your path to look like this: 
  23.  
  24.     c:\;c:\dos;c:\util;c:\util\rexx20\pgms;c:\windows;c:\windows\excel
  25.  
  26.     You create an ASCII (text) file that looks like this: 
  27.  
  28.     c:\
  29.     c:\dos
  30.     c:\util
  31.     c:\util\rexx20
  32.     c:\util\rexx20\pgms
  33.     c:\windows
  34.     c:\windows\excel
  35.  
  36.     Save the file giving any name you wish.  Let's say you name 
  37.     it PATH.TXT.  You would then create your path by executing 
  38.     the XPATH command as follows: 
  39.  
  40.     XPATH PATH.TXT
  41.  
  42.     The above format assumes that PATH.TXT is in your current 
  43.     directory and XPATH.EXE is in your current path or current 
  44.     directory. 
  45.  
  46.     If the file containing the directories you want in your 
  47.     path is not in your current directory when you execute 
  48.     XPATH, you can specify where the file is in the following 
  49.     way: 
  50.  
  51.     XPATH C:\DATA\PATH.TXT
  52.  
  53.     That is how you would do it if your path file is called 
  54.     PATH.TXT and is in a sub-directory on C called DATA. 
  55.  
  56.  
  57.  
  58.     XPATH.DOC Page  1                                               
  59.  
  60.  
  61.     Extra Features   
  62.     -------------- 
  63.  
  64.     But wait, there's more.  We have just added 3 new features!  
  65.  
  66.     You can now add and deleted from your path on the fly.  
  67.     Suppose you want to add the directory C:\WING to your path 
  68.     right away.  Simply type: 
  69.  
  70.        XPATH -A C:\WING
  71.  
  72.     That's all you have to do.  Xpath will add the new 
  73.     directory to the end of your current path.  It does not 
  74.     modify your path data file though, so the next time you 
  75.     reboot, the added path will not be there. 
  76.  
  77.     Suppose you want to delete the directory C:\WINDOWS out of your path. 
  78.     Simply type:
  79.  
  80.     XPATH -D C:\WINDOWS
  81.  
  82.     That's all you have to do.  The rest of your path remains 
  83.     intact, but C:\WINDOWS is removed. 
  84.  
  85.     The 3rd new feature added to xpath is the directory list 
  86.     feature. Simply type XPATH with no parameters, and all the 
  87.     directories in your path are listed on separate lines.  You 
  88.     can use this feature to create a file that can later be 
  89.     used as input to xpath in your autoexec.bat file.  For 
  90.     example: 
  91.  
  92.     Type:
  93.        XPATH -L >PATH.TXT
  94.  
  95.     You will get a file that has a list of directories in your 
  96.     path.  This file will also contain the xpath logo (and 
  97.     shareware information if you have not yet registered), so 
  98.     you will have to edit the file to delete that stuff.  
  99.     Remember to also delete the byte total at the end 
  100.     of the file.  Then save the file and use it as input to 
  101.     XPATH in your autoexec.bat file as described on the 
  102.     previous page. 
  103.  
  104.     IMPORTANT NOTE: If you have not registered your copy yet, a 
  105.     pause comes up and you are required to press enter after 
  106.     the pause. When you use the above method to create an input 
  107.     file for Xpath, you will not see the "press enter to 
  108.     continue" message", but you still have to press enter.  If 
  109.     you have an unregistered version, wait 3 seconds after 
  110.     typing XPATH >PATH.TXT and then press enter. 
  111.  
  112.     Starting with version 3.5, the total bytes in your path are 
  113.     reported when you type XPATH with no parameters.  I have 
  114.     found that some applications lock up when your path starts 
  115.     to get long.  The application that I had a problem with was 
  116.     BRIEF (a text editor).  When my path reached about 265 
  117.     bytes, BRIEF would lock up when I tried to invoke it. 
  118.  
  119.     > Type XPATH -? for help and examples.
  120.  
  121.  
  122.     XPATH.DOC Page  2                                               
  123.  
  124.  
  125.     Possible problems
  126.     -----------------
  127.  
  128.     One of the main reasons you would want to use xpath is 
  129.     because you want a path longer than 127 characters.  So, 
  130.     after using XPATH, if you type the PATH command to display 
  131.     your path, you may see that your path is longer than 127 
  132.     characters.  My path is 197 characters. When I run the 
  133.     setup program for the text-editor I use (BRIEF), it tries 
  134.     to insert d:\brief into my path.  At the time it does this, 
  135.     it is a little confused because it sees my path is longer 
  136.     than 127 characters.  It issues a warning message that says 
  137.     my path is too long, but no problems occur. 
  138.  
  139.     Anytime you run an install program that puts a path command 
  140.     in your autoexec.bat file, you will have to take that path 
  141.     command out and put that path in your path file that you 
  142.     use when you execute XPATH.  
  143.  
  144.     Some programs that read your path could have a problem with 
  145.     a path longer than 127 characters.  Some programs may stop 
  146.     searching the path after the 127th character, or even blow 
  147.     up when they find that your path is larger than 127 
  148.     characters.  I've only encountered this problem with BRIEF 
  149.     and a path greater than 165. 
  150.  
  151.     When your path gets unusually large, the whole thing may 
  152.     not display when you type the dos PATH or SET command.  The 
  153.     reason for this is that DOS doesn't expect your path to 
  154.     ever be longer than 127 bytes, so it gets confused when 
  155.     it's longer, and it prints just part of the path.  
  156.     Sometimes it will print the whole thing even when it's 
  157.     greater than 127 bytes, but to be sure you're seeing your 
  158.     whole path, type XPATH with no parameters when you want to 
  159.     see your path. 
  160.  
  161.     DOS 5.0
  162.  
  163.     After you have set your path with XPATH, using the DOS path 
  164.     command to look at your path will not work.  You will see 
  165.     only part of your path. The same is true when you look at 
  166.     your path by typing SET.  To see your path, type XPATH with 
  167.     no parameters.  Your path will list out -- each directory 
  168.     displaying on a new line.  
  169.  
  170.     Remember, the longer your path gets, the greater the 
  171.     possibility some applications will have of locking up.                    
  172.  
  173.       ONCE YOU HAVE CREATED A PATH > 127 CHARACTERS, DO NOT USE 
  174.       DOS'S SET OR PATH COMMAND TO CHANGE IT.  ONLY USE XPATH.  
  175.       IF YOU WISH TO QUIT USING XPATH, TAKE XPATH OUT OF YOUR 
  176.       AUTOEXEC.BAT AND REBOOT. 
  177.  
  178.  
  179.     Do not put equal signs (=) in your path input file.  This 
  180.     will cause extraneous = signs in your path which will 
  181.     confuse XPATH. 
  182.  
  183.  
  184.  
  185.     XPATH.DOC Page  3                                               
  186.  
  187.  
  188.  
  189.  
  190.     ENVIRONMENT SIZE PROBLEMS
  191.     -------------------------
  192.  
  193.     NEW PATH TOO LARGE TO FIT IN CURRENT ENVIRONMENT. PATH UNCHANGED.
  194.  
  195.     If you run out of environment space when using XPATH, this 
  196.     means you need to allocate more environment space.  If you 
  197.     have this problem when opening a DOS window under windows, 
  198.     skip to the next section.  If you have this problem when 
  199.     running XPATH from your AUTOEXEC.BAT file, then you need to 
  200.     increase your environment size by adding the following line 
  201.     to your config.sys file: 
  202.  
  203.  
  204.     shell = c:\command.com c:\ /p /e:640
  205.  
  206.     The /e:640 in the above line tells DOS to allocate 640 
  207.     bytes to your environment.  You may need to use a larger 
  208.     number if you have a lot of SETS in your AUTOEXEC.BAT file, 
  209.     or if you have a lot of directories in your XPATH directory 
  210.     file.  The above command assumes you are booting from a 
  211.     hard drive who's name is 'C'. 
  212.  
  213.     *********
  214.     WARNING: 
  215.     *********
  216.  
  217.     The shell command also tells DOS where your command.com 
  218.     file is located.  If you specify a location where 
  219.     COMMAND.COM does NOT exist, your PC will not boot up off 
  220.     the hard drive.  If this happens, you will have to boot 
  221.     from diskette and correct the problem in your config.sys 
  222.     file. 
  223.  
  224.     If you know you have a lot of environment space, but you 
  225.     still get the "path won't fit" message, then it may be 
  226.     because you are in a DOS shell.  Type EXIT to make sure you 
  227.     are not in a DOS shell. If you are, then typing EXIT will 
  228.     cause you to go back to the application you "shelled" out 
  229.     of. 
  230.  
  231.     DOS Compatibility
  232.     ----------------- 
  233.  
  234.     XPATH was written under DOS 3.30 and is compatible with DOS 
  235.     3.1 and higher -- including 5.0. 
  236.  
  237.  
  238.  
  239.     XPATH.DOC Page  4                                               
  240.  
  241.  
  242.     INCREASING ENVIRONMENT SIZE FOR A WINDOWS'S DOS WINDOW:
  243.     -------------------------------------------------------
  244.  
  245.     To increase your environment size for a DOS window under
  246.     Window's, you set up a PIF as follows:
  247.  
  248.     - Click on "Close window on exit" (turn it on).
  249.     - Program Filename:     COMMAND.COM
  250.     - Optional Parameters:  /E:640 /C C:\BAT\XPATHWIN.BAT
  251.  
  252.     The /E:640 allocates 640 bytes to your environment.  You 
  253.     can increase or decrease this if you wish.  The /C says the 
  254.     following filename is a BAT file to be executed.  You 
  255.     can use any filename you wish.  The bat file you execute 
  256.     should execute XPATH as well as any other commands you wish 
  257.     to execute.  Also, the last line in the bat file must 
  258.     execute command.com again.  This will keep your dos window 
  259.     from immediately returning to windows when the bat file is 
  260.     finished executing.  An example of a bat file for a DOS 
  261.     window that executes xpath is: 
  262.  
  263.     ECHO OFF
  264.     ECHO Setting path...
  265.     C:
  266.     CD \UTILS
  267.     XPATH C:\DATA\PATH.DAT
  268.     COMMAND.COM /E:640
  269.  
  270.     Why the /E:640 on the last line even though we already 
  271.     specified /E:640 in the PIF? Well, the /E:640 in the PIF 
  272.     gives 640 bytes of environment space for the bat file to 
  273.     use.  The bat file uses it, but then the last thing the bat 
  274.     file does is to load a new command environment.  When this 
  275.     occurs, the environment variables from the old command 
  276.     environment are copied to the new command environment. 
  277.     Thus, the new command environment needs at least as much 
  278.     environment space as was specified in the PIF. 
  279.  
  280.     If you have problems setting your path in a DOS window 
  281.     under Windows, you can set it before you enter windows, and 
  282.     all DOS windows will recognize it. 
  283.  
  284.  
  285.  
  286.  
  287.     XPATH.DOC Page  5                                               
  288.  
  289.  
  290.  
  291.  
  292.     Registering XPATH
  293.     ---------------
  294.  
  295.     You have an evaluation copy of XPATH.  Please register it by sending
  296.     $15.00 to:
  297.                         XWARE Development
  298.                         7351 Woburn Circle, Suite #1
  299.                         Anchorage, Alaska  99502
  300.  
  301.      Phone: (907) 248-1211
  302.  
  303.     By registering your copy of XPATH, you will be sent the 
  304.     latest version which will not have the pause in it.  You 
  305.     will be entitled to free technical support, and you will 
  306.     get future versions of XPATH at a reduced cost. 
  307.  
  308.  
  309.     The next version of Xpath will include automatic update of 
  310.     your path file when you add or delete from your path on the 
  311.     fly. 
  312.  
  313.  
  314.       [Please see the see last page for the XPATH registration form.]
  315.  
  316.  
  317.  
  318.     XPATH.DOC Page  6                                               
  319.  
  320.  
  321.  
  322.  
  323.     Current License Agreement - XPATH 3.7
  324.     -------------------------------------
  325.  
  326.     You are entitled to use the evaluation copy of XPATH for 
  327.     evaluation purposes only.  Use this registration form to 
  328.     purchase a copy of XPATH should you decide to continue to 
  329.     use it.  Purchasing a copy of XPATH entitles you to use it 
  330.     on one machine.  If XPATH is installed on a network, a 
  331.     license must be purchased for each workstation that access 
  332.     XPATH. 
  333.  
  334.     Feel free to upload the shareware version of XPATH to your 
  335.     favorite bulletin boards. 
  336.  
  337.     +-----------------+
  338.     :REGISTRATION FORM:  3.7
  339.     +-----------------+
  340.  
  341.  
  342.     Name: __________________________________________________________
  343.  
  344.     Company (if applicable): _______________________________________
  345.  
  346.     Address: _______________________________________________________
  347.  
  348.     Address: _______________________________________________________
  349.  
  350.     City: ______________________________State:_____ Zip:____________
  351.  
  352.  
  353.     No. of copies:  _____  (enclose $15 per copy)
  354.  
  355.     Amount enclosed: __________
  356.  
  357.     Make checks payable to XWARE Development.
  358.  
  359.     Send to:
  360.  
  361.                         XWARE Development
  362.                         7351 Woburn Circle, Suite #1
  363.                         Anchorage, Alaska  99502
  364.                         
  365.                         Phone: (907) 243-1211
  366.  
  367.                         CompuServe User-ID: 76424,1335
  368.  
  369.  
  370.     XPATH.DOC Page  7                                               
  371.  
  372.  
  373.  
  374.  
  375.                              XWARE Disclaimer
  376.      
  377.     XWARE specifically disclaims all warranties, expressed or 
  378.     implied, including but not limited to implied warranties of 
  379.     merchantability and fitness for a particular purpose 
  380.     with respect to defects in the software and documentation, 
  381.     and the program license granted herein in particular, and 
  382.     without limiting operation of the program license with 
  383.     respect to any particular application, use, or purpose. In 
  384.     no event shall XWARE be liable for any loss of profit or 
  385.     damage, including but not limited to special, incidental, 
  386.     or consequential damages. This statement shall be 
  387.     construed, interpreted, and governed by the laws of the 
  388.     State of Alaska. 
  389.  
  390.  
  391.  
  392.  
  393.     XPATH.DOC Page  8                                               
  394.  
  395.                             -- End XPATH.DOC --
  396.  
  397.